home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / g_man / cat3 / standard / blink.z / blink
Text File  |  1998-10-20  |  3KB  |  67 lines
  1.  
  2.  
  3.  
  4. bbbblllliiiinnnnkkkk((((3333GGGG))))                                                            bbbblllliiiinnnnkkkk((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      bbbblllliiiinnnnkkkk - changes a color map entry at a selectable rate
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd bbbblllliiiinnnnkkkk((((rrrraaaatttteeee,,,, iiii,,,, rrrreeeedddd,,,, ggggrrrreeeeeeeennnn,,,, bbbblllluuuueeee))))
  13.      sssshhhhoooorrrrtttt rrrraaaatttteeee;;;;
  14.      CCCCoooolllloooorrrriiiinnnnddddeeeexxxx iiii;;;;
  15.      sssshhhhoooorrrrtttt rrrreeeedddd,,,, ggggrrrreeeeeeeennnn,,,, bbbblllluuuueeee;;;;
  16.  
  17. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  18.      _r_a_t_e    expects the number of vertical retraces per blink.  On the
  19.              standard monitor, there are 60 vertical retraces per second.
  20.  
  21.      _i       expects an index into the current color map.  The color defined
  22.              at that index is the color that is blinked (alternated).
  23.  
  24.      _r_e_d     expects the red value of the alternate color that blinks against
  25.              the color selected from the color map by the _i parameter.
  26.  
  27.      _g_r_e_e_n   expects the green value of the alternate color that blinks
  28.              against the color selected from the color map by the _i parameter.
  29.  
  30.      _b_l_u_e    expects the blue value of the alternate color that blinks against
  31.              the color selected from the color map by the _i parameter.
  32.  
  33. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  34.      bbbblllliiiinnnnkkkk alternates the color located at index _i in the current color map
  35.      with the color defined by the parameters _r_e_d, _g_r_e_e_n, and _b_l_u_e. The rate
  36.      at which the two colors are alternated is set by the _r_a_t_e parameter. The
  37.      maximum number of color map entries that can be blinking simultaneously
  38.      on a screen is returned by the ggggeeeettttggggddddeeeesssscccc inquiry GD_NBLINKS.
  39.  
  40.      The length of time between retraces varies according to the monitor used.
  41.      On the standard monitor, there are 60 retraces per second, so a _r_a_t_e of
  42.      60 would cause the color to change once every second.
  43.  
  44.      To terminate blinking and restore the original color for a single color
  45.      map entry, call bbbblllliiiinnnnkkkk for that entry with _r_a_t_e set to 0.
  46.  
  47.      To terminate all blinking colors simultaneously, call bbbblllliiiinnnnkkkk with _r_a_t_e set
  48.      to -1.  When _r_a_t_e is -1, the other parameters are ignored.
  49.  
  50. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  51.      getgdesc, mapcolor
  52.  
  53. NNNNOOOOTTTTEEEESSSS
  54.      This routine is available only in immediate mode.
  55.  
  56. BBBBUUUUGGGGSSSS
  57.      bbbblllliiiinnnnkkkk always operates on the colormap of the normal framebuffer,
  58.      regardless of the current drawmode.  It is not possible to blink overlay
  59.      or underlay colors.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.